home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 096 / calla36c.arc / CALLANA.DOC < prev   
Text File  |  1985-02-21  |  20KB  |  360 lines
  1. @CB
  2.  
  3.  
  4.  
  5.                                                                         1
  6.  
  7.  
  8.                                   THE CALL ANALYZER
  9.                   Version 3.0 written for RBBS-PC CPC12.3B or later
  10.                            by Lee Nelson and Jerry Sanders
  11.                                        Atlanta
  12.                                   February 17, 1985
  13.           
  14.           
  15.           The CALL  ANALYZER is  copyright 1984,  1985 by AlphaSoft System,
  16.           2508 Constance  St., Atlanta,  GA 30344,  phone (404) 761-8137. A
  17.           limited license  is granted  to distribute this software with the
  18.           following conditions:
  19.           
  20.                   (1) No profit is charged for distribution.
  21.                   (2) This program is not distributed in altered form.
  22.                   (3) This statement is not removed.
  23.                   (4) These files will only be distributed under the names
  24.                       of CALLA30x.LBR (where x is the current release level
  25.                       indicator) and not separated from documentation.
  26.           
  27.           
  28.           NEW FEATURES IN VERSION 3.0
  29.           
  30.            (1)  Support for RBBS-PC CPC12.3B thru CPC12.3C has been added
  31.            (2)  Support for RBBS-PC X3D has been added
  32.            (3)  2400 baud callers are now supported
  33.            (4)  Up to 1,000 differently named download files can now be
  34.           accommodated
  35.            (5)  Once more than 1,000 files have been analyzed the Call
  36.           Analyzer will  no longer terminate, but instead will report on
  37.           the summary statistics for that portion of the CALLERS file which
  38.           was read to that point
  39.            (6)  A new graphing system has been added.  System utilization
  40.           distribution is now averaged and summarized in a multi-color bar
  41.           graph to illustrate periods of highest and lowest utilization by
  42.           percentage
  43.            (8)  Certain routines have been optimized to improve performance
  44.            (9)  Various reported errors have been fixed
  45.           (10)  Registration price has been lower from $25 to $15
  46.           
  47.           
  48.           
  49.                If you find this program to be of use, please send $15 along
  50.           with the  registration form  to AlphaSoft  Systems at  the  above
  51.           address. A registration form has been provided at the end of this
  52.           documentation for  the purpose  of registering  your copy  of the
  53.           CALL ANALYZER.  Users who  pay this fee will receive a registered
  54.           copy of  the latest  version of  the CALL ANALYZER at the time of
  55.           registration. They  are also  eligible for  telephone support for
  56.           problems and  questions about  this software.  In addition,  they
  57.           will receive  mail notification  of the  availability of the next
  58.           new release of this software. Our technical support line is (404)
  59.           761-8137 after  7 PM.  We will need to know the name in which the
  60.           software was  registered and  the program serial number before we
  61.           can provide technical support.
  62.  
  63.  
  64.  
  65.                                                                         2
  66.  
  67.  
  68.           
  69.           DESCRIPTION:
  70.           
  71.                The CALL  ANALYZER program  is a  self contained statistical
  72.           analysis program for use in summarizing and categorizing the user
  73.           activity on  an RBBS-PC  system. It  is designed to work with the
  74.           caller file  of any version of RBBS-PC from CPC12.3B or later. It
  75.           has been  thoroughly tested  with CPC12.3B.  Certain  version  of
  76.           RBBS-PC prior  to CPC12.3B  do not log all of the caller activity
  77.           that CALL ANALYZER looks for. Garbage records in the caller files
  78.           of some  earlier versions  of RBBS can also cause problems in the
  79.           CALL ANALYZER.  The only  solution to  this problem is to upgrade
  80.           your RBBS-PC system to CPC12.3B or later.
  81.           
  82.           DISCLAIMER NOTICE:
  83.           
  84.                The CALL  ANALYZER should  run on  earlier version  of  RBBS
  85.           prior to CPC12.3B. However, you will not get the full features of
  86.           the system  and Alphasoft  Systems will be under no obligation to
  87.           support paid  users with  problems caused  by files  from version
  88.           earlier than CPC12.3B.
  89.                You must  have a  CALLERS file  that spans  a mimimum  of 24
  90.           hours in  order to  run the  ANALYZER.  A CALLERS file of smaller
  91.           size may  produce errors  or distorted  statistics.   At any rate
  92.           such  information   even  if   accurate  would   me  meaningless.
  93.           Therefore problems  that might  arise from using such a file will
  94.           not be supported by AlphaSoft Systems.
  95.           
  96.           REQUIREMENTS:
  97.           
  98.                The CALL  ANALYZER is  designed  to  run  on  an  IBM-PC  or
  99.           compatible with  a minimum of 256K and at least 1 diskette drive.
  100.           It can  be used  with either  the IBM  Monochrome monitor  or any
  101.           compatible color monitor. In addition a printer is recommended to
  102.           produce hardcopy  reports. The  printer however  is optional. The
  103.           only other  requirement is a caller file from RBBS-PC CPC12.3B or
  104.           later.
  105.           
  106.           INSTALLATION:
  107.           
  108.                The CALL  ANALYZER will self install each time it is brought
  109.           up unless  it is  able to  find a valid configuration file in the
  110.           current sub-directory  of the default disk drive. The file, named
  111.           CALLA30C.CNF will be produced the 1st  time the system is brought
  112.           up.  It   will  prompt  the  user  for  certain  system  specific
  113.           information. You  will  be  asked  whether  you  wish  to  use  a
  114.           monochrome or color monitor and for the full name of your RBBS-PC
  115.           caller file.  The standard name for this file is CALLERS. However
  116.           some users  have renamed  this file  in the RBBS-PC configuration
  117.           process.
  118.  
  119.  
  120.  
  121.                                                                         3
  122.  
  123.  
  124.                In either case you must reply with the complete name of your
  125.           caller file. In addition you will be prompted for a file spec for
  126.           permanent storage  of the callers statistics. This message can be
  127.           replied to  with either  a standard DOS file name or a DOS device
  128.           specification such as a printer, e.g, LPT1:, LPT2:, CALLDATA.STA.
  129.                Any valid  DOS file  specification is acceptable. However, a
  130.           filename of  TRACE will  cause the  CALL ANALYZER  to prompt  for
  131.           trace options.   The  trace facility  will substantially  degrade
  132.           program performance  and therefore will normally be used only for
  133.           debuging purpose as require for support from AlphaSoft.
  134.                Upon exiting  the CALL  ANALYZER, you  will be  asked if you
  135.           wish to make a permanent copy of the statistics. This DOS file or
  136.           device  specification   will  dictate   the  destination  of  the
  137.           permanent copy  if you should reply yes to this prompt. This data
  138.           can be  sent to  a printer  or to  a file  for eventual  input to
  139.           another program such as LOTUS 1-2-3.
  140.                If the need arises to alter any of the initial configuration
  141.           options, i.e.  CALLERS file  name or  TRACE  options,  etc.,  you
  142.           should simply  delete the CALLA30C.CNF file and  rerun  the  CALL
  143.           ANALYZER.  This will causes the system to prompt for a new set of
  144.           configuration parameters.
  145.                
  146.           
  147.           USE AND FUNCTIONS:
  148.           
  149.                With the caller file in the default drive and sub-directory,
  150.           issue the  command CALLANA  at the  DOS prompt. The startup panel
  151.           will appear. The display at the bottom will indicate which caller
  152.           record is  currently being  read.   The CALL  ANALYZER reads  the
  153.           CALLERS file  backwards, beginning with the largest record number
  154.           and decerments  towards one.  When this number reaches one or the
  155.           unique file  name count  reaches  the  1,000  limit,  the  system
  156.           statistics main  screen will  be displayed.  The first  screen is
  157.           made up  of 3  sections. The  2 on  the left  display  statistics
  158.           relating to caller information such as baud rate, parity settings
  159.           and total  callers.  The  other  section  on  the  left  contains
  160.           statistics relating  to the  the RBBS  file  section.  The  right
  161.           section contains  an alphabetically sorted list of all files that
  162.           have been  downloaded from  the system,  with  a  total  download
  163.           count. This  section can  be paged forward or backwards using the
  164.           PgUP and PgDn keys.
  165.                The Home  and End  keys position  the files  section to  the
  166.           bottom or  top of the download list. At this point the F1 key can
  167.           be pressed  to update the left side of the screen with additional
  168.           statistics about  the overall  utilization of  the  RBBS  system.
  169.           Pressing  the   F1  key  a  third  time  will  produce  a  system
  170.           utilization bar graph.  Further pressing of the F1 key cycles you
  171.           back to the first display screen.
  172.                You may   exit  the CALL  ANALYZER at  any point by pressing
  173.           the Esc  key. At  this point  the system  will ask if you wish to
  174.           direct the  report to  the  output  device/filespec.  If  you  so
  175.           desire, simply reply with a Y. If no report is desired a reply of
  176.           N will  terminate the  program.  A  menu  of  all  CALL  ANALYZER
  177.           keyboard functions  is displayed  at the  bottom of the screen at
  178.  
  179.  
  180.  
  181.                                                                         4
  182.  
  183.  
  184.           all times  except during bar graph display.  However all function
  185.           key always operational.
  186.           
  187.           UNDERSTANDING THE BAR GRAPH:
  188.           
  189.                During the  beta test phase for release 3.0, several testers
  190.           commented that  they really  didn't understand  what the "Average
  191.           Percentage of  Hourly Usage"  really  was.    Therefore  we  have
  192.           decided to  include an  explanation for  the chart  and the  data
  193.           which it represents.  The horizontal axis of the graph represents
  194.           the 24  hours of  each day.   The  vertical axis  represents  the
  195.           percentage of  utilization of  each  hour  of  the  day  averaged
  196.           together over  the  period  of  the  callers  file.    The  total
  197.           percentage is calculated by adding up the total number of minutes
  198.           the RBBS system was in use each day, during each hour of the day.
  199.           This total  is divided by the total number of days for which each
  200.           separate  hour  was logged  into the callers file.  Callers files
  201.           which begin  and end  at times other than midnight will have more
  202.           days activity  for certain hours (on the first and/or last day of
  203.           the callers  file) than  for others.   This  has been  taken into
  204.           account when gathering and graphing these statistics.
  205.                The bar  chart itself,  taken as a whole, should provide the
  206.           RBBS SYSOP  with a visual picture of the peaks and valleys of his
  207.           systems' utilization.   This  information might  be used for many
  208.           purposes such  as deciding  when the least impact will be felt by
  209.           users when  bringing the  system down  for maintenance.  It  also
  210.           shows the  SYSOP how much room his system has left for additional
  211.           growth and  where that  growth can  best be  funneled in terms of
  212.           times of the day when access and utilization are lowest.
  213.                We have found that by identifying slack periods of an RBBS's
  214.           utilization to  its users,  they will change their calling habits
  215.           to fill in those slack periods.
  216.           
  217.           
  218.           LIMITATIONS AND RECOMMENDATIONS:
  219.           
  220.                Due to  the nature  of the  internal sort, the CALL ANALYZER
  221.           can only  handle caller  files with  no more than 1,000 different
  222.           named  download  files  or  32,676  caller  file  records.  As  a
  223.           benchmark I  have run  CALL ANALYZER  against a caller file which
  224.           contained 5,646  records. This  represented 611  different named
  225.           download files  for  a  total  of  3,331  total  downloads.  This
  226.           particular caller  file spanned  a period  of 30  days of 24 hour
  227.           operation. System  utilization ran  at 50%.  The system contained
  228.           approximately 1600  download files.  Under standard  DOS 3.0, the
  229.           CALL ANALYZER took 4 mins and 15 seconds to run.
  230.                Under Multi-Job,  with 2  partitions  and  RBBS-PC  CPC12.3B
  231.           running in the background, using the same caller file, the system
  232.           took 9  mins and  55 seconds  to run.  Experience with  MultiLink
  233.           Advanced 3.0  indicates that  CALL  ANALYZER  will  probably  run
  234.           approximately the  same as  under Multi-Job.  Based on  these run
  235.           times, we  recommend that  a caller  file that  is one  month (31
  236.           days) in  length  is  probably  ideal.  Such  a  file  should  be
  237.           processed in a reasonable time (less than 10 minutes) and in most
  238.  
  239.  
  240.  
  241.                                                                         5
  242.  
  243.  
  244.           cases should not be capable of taxing the limitations of the CALL
  245.           ANALYZER. In  addition, if  the user  establishes a specific time
  246.           each month  (say the  last day  of the month) to run this program
  247.           and then  deletes or  archives the  caller file  and starts a new
  248.           one, he  will be  able to compare statistics from month to month.
  249.           The printed report is ideal for month to month comparisons.
  250.           
  251.           FUTURE ENHANCEMENTS:
  252.           
  253.                In a future release we will be converting some of the longer
  254.           running routines  to assembler  to improve  run time.   Also  the
  255.           graphics display  system will be moved to another module to allow
  256.           additional graphic displays.
  257.                One  of   the  current  problems  in  producing  utilization
  258.           statistics from  RBBS is that you must assume that the system was
  259.           available 24  hours a  day 7  days a week.  All SYSOP's know that
  260.           from time  to time this just isn't the case.  We have proposed to
  261.           Tom Mack  that an  RBBS system  start up  record and  possibly  a
  262.           system shutdown record be added to the callers file.  Tom said he
  263.           would consider  this, and  hopefully it  will be  in the CPC12.3C
  264.           version currently  scheduled for  release on  Feb 17,  1985.   If
  265.           these records  are provided  many more  statistical analyses  are
  266.           possible.
  267.                Also we  would like  to eventually  add a  master file  into
  268.           which all  of these  statistics are  permanently stored  and with
  269.           each run  of the  ANALYZER, these  files would  be updated.  This
  270.           would give  SYSOP's a  much better  history of download files and
  271.           long term utilization.
  272.                Currently the  permanent output  file from  CALL ANALYZER is
  273.           designed primarily  for output  to a  hardcopy printer.  One beta
  274.           tester has  shown interest  in trying  to develop  a LOTUS  1-2-3
  275.           worksheet for  graphing and  comparing RBBS-PC  statistics.  This
  276.           permanent output  data set  can serve  as the source of data into
  277.           the LOTUS  system. If we find that there is a general interest in
  278.           this, we  will develop  a new output section to the program.  Let
  279.           us know if you would be interested in seeing this.
  280.                We will  continue to  add additional  features to the system
  281.           from time  to time,  as well  as keep it up to date with the most
  282.           current release  of  RBBS-PC.  In  the  future  we  plan  to  add
  283.           additional statistics  from the  caller  file  and  provide  some
  284.           statistical peeks at the RBBS message and user files.
  285.                If you  have any  ideas or  suggestions that you think might
  286.           improve the CALL ANALYZER, please call us voice at (404) 761-8137
  287.           after 7:00  PM EST, call my BBS at (404) 761-3635 or write us and
  288.           tell us  about it.  We anticipate  a new release of this software
  289.           about every 2 or 3 months.
  290.           
  291.           RBBS-PC is copyrighted by Tom Mack and Jon Martin, of the Capitol
  292.           City PC Users Group. Washington, D.C.
  293.           Multi-Job is  a registered  trademark of B & L Computer Software,
  294.           Boise, Idaho
  295.           MultiLink  is  a  registered  trademark  of  The  Software  Link,
  296.           Atlanta, Georgia
  297.  
  298.  
  299.  
  300.                                                                         6
  301.  
  302.  
  303.           LOTUS and  1-2-3 are  registered trademarks  of Lotus Development
  304.           Corp.
  305.           
  306.           
  307.           
  308.           
  309.           
  310.           
  311.           
  312.           
  313.           
  314.           CALL ANALYZER REGISTRATION FORM
  315.           
  316.           To register  your copy  of this software please complete the form
  317.           below and  return along  with  $10  to  Alphasoft  Systems,  2508
  318.           Constance St.,  Atlanta, Georgia  30344.  You  will  receive  the
  319.           latest version  of CALL  ANALYZER by mail within 4 weeks. You may
  320.           call our  technical support  line as  soon  as  we  receive  your
  321.           registration form.
  322.           
  323.           NAME:_______________________________________________________
  324.           
  325.           ADDRESS:____________________________________________________
  326.           
  327.           CITY:_______________________________ STATE:_________________
  328.           
  329.           ZIP:____________________________
  330.           
  331.           Where did you acquire this copy of the CALL ANALYZER ?
  332.           ____________________________________________________________
  333.           
  334.           What is the serial number under the logo of the version you now
  335.           have? __________________________
  336.           
  337.           Specify disk format you require for the new release:
  338.           
  339.            _____SS/SD _____DS/DD 8 sector _____DS/DD 9 sector
  340.           
  341.           Suggestions or Comments:
  342.           
  343.           
  344.           ________________________________________________________________
  345.           
  346.           ________________________________________________________________
  347.           
  348.           ________________________________________________________________
  349.           
  350.           ________________________________________________________________
  351.           
  352.           ________________________________________________________________
  353.           
  354.           ________________________________________________________________
  355.           
  356.           ________________________________________________________________
  357.  
  358.  
  359.  
  360.